home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 16 / taper.zip / EDMAN < prev    next >
Text File  |  1986-04-18  |  98KB  |  2,773 lines

  1.         
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                            ED - A PROGRAM TEXT EDITOR
  27.  
  28.                                  USER'S MANUAL
  29.  
  30.                                     Rev 1.05
  31.  
  32.                          (c) Copyright Ed Gilbert 1984
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  70.  
  71.  
  72.  
  73.         1.  GENERAL INFORMATION  
  74.  
  75.         ED is a full screen text editor program.  Versions of the program
  76.         exist to  run  on a  variety  of MS-DOS  computers  made by  IBM,
  77.         Hewlett-Packard, and others.   These include  the IBM  models PC,
  78.         XT, AT, and  the Hewlett-Packard  models 150, 110,  110-Plus, and
  79.         Vectra.  
  80.  
  81.         The basic operation of the editor is to create and edit disk text
  82.         files.  Files are  read from a  disk into the  editor's workspace
  83.         buffer where the editing  changes occur.  No changes  are made to
  84.         the original  disk file  until a  command is  given to  write the
  85.         workspace buffer back onto the disk.   The editor has commands to
  86.         insert, delete, and  change the text  in this buffer.   Since the
  87.         entire file resides in  memory during the edit  session, any part
  88.         of the file can be accessed quickly.  
  89.  
  90.         The editor makes  use of  all available  computer memory  so that
  91.         large files can be edited.  The  editor itself requires about 45K
  92.         bytes for its execution.   The remaining memory  is available for
  93.         use as the  editor's file  buffer(s).  On most  MS-DOS computers,
  94.         this limits the  maximum size  of a  file that  can be  edited to
  95.         about 580K bytes.  
  96.  
  97.         The editor's  commands  are optimized  for  working with  program
  98.         source files.  It  is not  designed to be  a word  processor, al-
  99.         though some basic word processing  functions such as tab setting,
  100.         wordwrap and paragraph  formatting are included.   A good comple-
  101.         ment of  file and  block commands  exist for  moving sections  of
  102.         program code between and within files.  Some of the more advanced
  103.         commands  include  split-screen,  multi-file   editing,  and  the
  104.         ability to  execute  MS-DOS  commands,  including  running  other
  105.         programs, from within the editor.   The word processing functions
  106.         are intended for  program documentation,  and are  usually suffi-
  107.         cient for memos,  letters or  other short documents.   A separate
  108.         text formatting program is  required for printing  with page for-
  109.         matting, margins, headers, print font enhancements, etc.  
  110.  
  111.         The editor has two types of commands.  Frequently used functions,
  112.         such as scrolling or deleting  characters, are invoked by editing
  113.         keys that  are  generally  labelled  for these  purposes  on  the
  114.         keyboard.  Less frequently used, but more powerful, or broader in
  115.         scope, are the multi-keystroke commands.  These commands are used
  116.         to control file, block, search/replace  and other such functions.
  117.         All multi-keystroke  commands are  begun by  pressing the  ESCAPE
  118.         key, followed  by one  or more  additional keys.   The additional
  119.         keystrokes are the  first characters  of the command  names being
  120.         selected.  While entering a command, the choices are visible on a
  121.         command line, and a second line gives a full sentence description
  122.         of any command keyword.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.         (E.Y.G.)                      - 1 -             (printed 4-18-86)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  136.  
  137.  
  138.  
  139.         1.1  Program Versions and Requirements  
  140.  
  141.         Several versions of the editor  exist to accomodate the differen-
  142.         ces between IBM  and Hewlett-Packard MS-DOS  computers.  The dif-
  143.         ferences between these versions  are in the  keyboard and display
  144.         code.  The commands and  functions of all versions  of the editor
  145.         are otherwise identical.  
  146.  
  147.         All versions of the  editor require MS-DOS version  2.0 or later,
  148.         and at  least 60K  bytes of  free memory.   Additional memory  is
  149.         recommended.  The editor makes use of all available memory.  
  150.  
  151.         The IBM PC version  of the editor  runs on the  PC, PC-Jr, PC-XT,
  152.         PC-AT, and  compatible computers  from other  manufacturers (e.g.
  153.         AT&T, Compaq,  and  HP-Vectra).   It  will run  with  either  the
  154.         Monochrome  or  Color  display  cards.   If  a  system  has  both
  155.         monochrome  and  color   display  cards,  the   editor  uses  the
  156.         monochrome display.   White characters  are formed  on the  color
  157.         display using a black background.  
  158.  
  159.         The HP150 version of the editor runs on the A, B, and C models.  
  160.  
  161.         Except where it explicitly mentions  differences, this manual ap-
  162.         plies to all program versions.  This  manual will use the editing
  163.         key names that appear  on the HP150 and  HP110 keyboards.  If the
  164.         IBM keyboard uses a different key  to accomplish the same action,
  165.         the equivalent IBM key will be given in parentheses.  
  166.  
  167.  
  168.  
  169.  
  170.         2.   EDITOR OPERATION  
  171.  
  172.         This section describes the operation of  the editor.  Some of the
  173.         commands and  editing keys  are  also discussed,  but Section  3,
  174.         "General Reference", is a  more complete reference  to these sub-
  175.         jects.  
  176.  
  177.  
  178.  
  179.         2.1  Running the Editor  
  180.  
  181.         From the MS-DOS command  prompt (>), type "ed".   When the editor
  182.         is first run, it prompts for the name  of a file to to edit.  For
  183.         example, to edit file sample.pas: 
  184.  
  185.               A>ed
  186.               Edit what file? sample.pas
  187.  
  188.         You can include the name  of the file to be  edited on the MS-DOS
  189.         command line.  For example: 
  190.  
  191.  
  192.  
  193.  
  194.  
  195.         (E.Y.G.)                      - 2 -             (printed 4-18-86)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  202.  
  203.  
  204.  
  205.               A>ed sample.pas
  206.  
  207.         In both examples the file sample.pas  is searched for in the cur-
  208.         rent directory.  If  the file is  found, the entire  file is read
  209.         into a buffer and the beginning  lines of the file are displayed.
  210.         If the file is not found, a file  of that name will be created in
  211.         the current directory when the buffer is saved.  
  212.  
  213.  
  214.  
  215.         2.2  Crossing Directories  
  216.  
  217.         If the editor is not  in the current directory,  you must use the
  218.         MS-DOS PATH command  to set the  path to its  directory.  For ex-
  219.         ample, if ED is in the directory  \utils, you can set the path by
  220.         typing 
  221.  
  222.               A>path \utils 
  223.  
  224.         If you want to edit a file  that is not in the current directory,
  225.         you can specify the path as part of the filename.  Examples: 
  226.  
  227.               A>ed  \user\c_comp\prog.c
  228.               A>ed  applic\prog.bas
  229.               A>ed  ..\stdio.h 
  230.  
  231.  
  232.  
  233.         2.3  Exiting the editor  
  234.  
  235.         If you want  to abandon a  file buffer without  saving your work,
  236.         use the command File Quit.  If any  changes have been made to the
  237.         current file buffer  during the  edit session,  you are  asked to
  238.         confirm the command.  Select Yes to exit, or No to continue edit-
  239.         ing.  If you exit a buffer when  two file buffers are in use, the
  240.         other file buffer  becomes active  and is  displayed.  If  only a
  241.         single file buffer is in use, the editor exits to MS-DOS.  
  242.  
  243.         The File  Save+exit command  saves  the current  file buffer  and
  244.         either switches  to the  other file  buffer or  exits to  MS-DOS,
  245.         depending on whether one or two file buffers are active.  
  246.  
  247.  
  248.  
  249.         2.4  Use of Computer Memory  
  250.  
  251.         When the editor is  run, it normally obtains  from MS-DOS all but
  252.         the top  14K  bytes (19K  on  IBM-PC) of  available  RAM for  its
  253.         workspace.  This top portion of RAM is used by the MS-DOS command
  254.         parser, COMMAND.COM.   If  it is  overwritten  by an  application
  255.         program such as ED,  it must be reloaded  when the application is
  256.         finished running.  
  257.  
  258.  
  259.  
  260.  
  261.         (E.Y.G.)                      - 3 -             (printed 4-18-86)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  268.  
  269.  
  270.  
  271.         The editor  can only  edit  files that  fit  entirely within  its
  272.         workspace.  If you are editing a very large file and need the ad-
  273.         ditional 14K bytes of memory, you can  use the /a switch from the
  274.         MS-DOS command  line  to obtain  the  additional memory  for  the
  275.         editor's workspace.  For example: 
  276.  
  277.               A>ed sample.pas /a
  278.  
  279.         If you use the /a  switch, the upper part  of COMMAND.COM will be
  280.         overwritten.  When you  exit the  editor, MS-DOS will  attempt to
  281.         reload the part of COMMAND.COM that  was overwritten.  If it can-
  282.         not be found  on your disk,  the computer will  display a message
  283.         asking you to insert your system disk into the drive.  
  284.  
  285.  
  286.  
  287.         2.5  File Buffers  
  288.  
  289.         A buffer is a region  of memory in the  computer that holds data.
  290.         The editor makes use of several  buffers.  Files being edited are
  291.         read from disk into a file workspace buffer, and any changes made
  292.         to the file held in the buffer do not affect the file on the disk
  293.         until you  explicitly command  the buffer  to be  written to  the
  294.         disk.  
  295.  
  296.         The editor has two file buffers,  allowing two files to be edited
  297.         at the same time.  These are  allocated dynamically from the pool
  298.         of memory that  is available  to the editor.   There is  no fixed
  299.         limit on the size of these  buffers, except that their sum cannot
  300.         exceed the available  free memory in  the computer.  The  size of
  301.         the current  file buffer,  and  the size  of  the remaining  free
  302.         memory are displayed on the status line.  
  303.  
  304.  
  305.  
  306.         2.5.1  The Block Buffer  
  307.  
  308.         The editor  maintains a  block  buffer for  copying, moving,  and
  309.         deleting blocks  of  text.  The  block  buffer uses  only  enough
  310.         memory to hold a deleted or copied  block, and it holds this text
  311.         until it is overwritten by another block command.  
  312.  
  313.  
  314.  
  315.         2.5.2  The Deleted Line Buffer  
  316.  
  317.         Whenever a single  line is deleted,  either with the  DELETE LINE
  318.         (SHIFT-DEL) key or the CLEAR LINE  (SHIFT-END) key, a line buffer
  319.         keeps a copy of the deleted line.   It can be recovered using the
  320.         Undelete command.  The line buffer  stores only the most recently
  321.         deleted line.  This  buffer has a  maximun length of  500 charac-
  322.         ters.  If you delete a line longer  than this, only the first 500
  323.         characters of the line can be recovered.  
  324.  
  325.  
  326.  
  327.         (E.Y.G.)                      - 4 -             (printed 4-18-86)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  334.  
  335.  
  336.  
  337.         2.6  Edit Modes  
  338.  
  339.         The editor has  two basic  modes of  operation, command  mode and
  340.         edit mode.  In  the edit  mode, the  cursor can  be moved  to any
  341.         character in the file  buffer using the cursor  control keys, and
  342.         text can be entered from the keyboard into the file at the cursor
  343.         location.  Edit  mode has  two forms  of text  entry, INSERT  and
  344.         REPLACE.  In the  INSERT mode,  characters are inserted  into the
  345.         file buffer to the left of  the cursor position.  When the editor
  346.         is first run, it  wakes up in  this mode, and the  word INSERT is
  347.         displayed on the status line.  
  348.  
  349.         The INSERT CHAR  (INS) key  toggles the form  of text  entry from
  350.         INSERT to REPLACE,  and vice  versa.  In  the REPLACE  mode, each
  351.         character entered from the keyboard  over-writes the character at
  352.         the cursor's location.  
  353.  
  354.  
  355.  
  356.         2.7  Command Mode  
  357.  
  358.         Commands make larger  changes to  the file  buffer or  change the
  359.         editing environment.   The  editor commands  are  organized as  a
  360.         multi-level menu.  The  command mode  is entered by  pressing the
  361.         ESCAPE key.  In  this mode, the  top line  of the screen  shows a
  362.         menu of keywords.  One of the keywords is always highlighted, and
  363.         the message line gives a description of this keyword.  
  364.  
  365.         Command keywords are selected in one of two ways: 
  366.  
  367.           1.  Use the  cursor  control  keys  to  highlight  the  desired
  368.               keyword, then press the RETURN key.  
  369.  
  370.           2.  Enter the first character of  the desired keyword.  This is
  371.               the faster method  once you  become familiar with  the com-
  372.               mands.  
  373.  
  374.         Many commands require  several keystrokes  before the  command is
  375.         completed.  You can back up out of  the command tree one level at
  376.         a time using the ESCAPE key.  
  377.  
  378.         Some  commands  prompt  you  to  enter  information,  such  as  a
  379.         filename, a line number, or a  search string.  Most such commands
  380.         remember and initially display your  previous entry.  The follow-
  381.         ing rules apply: 
  382.  
  383.            -  To enter the old response again  press the RETURN key.  Any
  384.               other key will erase  your previous response  and begin the
  385.               new input.  
  386.  
  387.            -  To edit your input, use the BACKSPACE key.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.         (E.Y.G.)                      - 5 -             (printed 4-18-86)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  400.  
  401.  
  402.  
  403.            -  To complete your input, use the RETURN key.  
  404.  
  405.            -  To cancel the command  and backup to the  previous level in
  406.               the command tree, use the ESCAPE key.  
  407.  
  408.         Some commands  take  several seconds  to  complete.  During  this
  409.         time, the command line  displays "WAIT .....".   When the command
  410.         successfully completes, the editor returns to the edit mode.  
  411.  
  412.         Sometimes a command cannot  be completed.  Perhaps  a file cannot
  413.         be opened, or a search string cannot  be found.  In this case the
  414.         editor beeps and displays a message  in inverse video on the mes-
  415.         sage line.  The editor may be left in either the edit mode or the
  416.         command mode, whichever is more appropriate for the next action.  
  417.  
  418.  
  419.  
  420.         2.8  The Display Screen  
  421.  
  422.         The editor's display  screen is  divided into separate  areas for
  423.         the text of the file(s) being edited and status information about
  424.         the editing environment.  
  425.  
  426.  
  427.  
  428.         2.8.1  The Command Line  
  429.  
  430.         The top line of the  screen is the command  line.  In the command
  431.         mode, this  line displays  command keywords.   In the  edit mode,
  432.         this line identifies the editor program name and revision.  
  433.  
  434.  
  435.  
  436.         2.8.2  The Message Line  
  437.  
  438.         The second line of the  screen is the message  line.  In the edit
  439.         mode it displays the name of the  file being edited.  In the com-
  440.         mand mode, a description  of the highlighted  command keyword ap-
  441.         pears on this line.  
  442.  
  443.  
  444.  
  445.         2.8.3  The Status Line  
  446.  
  447.         The third line displays  information about the state  of the cur-
  448.         rent or active file buffer.  The  individual fields of the status
  449.         line are  described below  in  the order  in  which these  fields
  450.         occur, beginning with the leftmost field.  
  451.  
  452.           CAPS    If the caps lock key is  active, this field is visible.
  453.                   Otherwise, this field is blank.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.         (E.Y.G.)                      - 6 -             (printed 4-18-86)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  466.  
  467.  
  468.  
  469.           INSERT/REPLACE 
  470.                   The current  mode of  text input  is displayed  in this
  471.                   field.  
  472.  
  473.           COL=    The column  number occupied  by  the cursor,  beginning
  474.                   with column 1 as the leftmost column.  
  475.  
  476.           LINE=   The number of the line containing the cursor, beginning
  477.                   with line 1 as the first line of the file buffer.  
  478.  
  479.           CHARS=  The number of characters in the current file buffer.  
  480.  
  481.           FREE=   The number of bytes of free memory available to be used
  482.                   in the editor's file buffers.  
  483.  
  484.           CA      If the Define Case  command has been  given, this field
  485.                   is visible.  It  indicates that the  Search and Replace
  486.                   commands are sensitive to the  case of alpha characters
  487.                   in the search pattern.  
  488.  
  489.           SP      If the  Define  No-tabs command  has  been given,  this
  490.                   field is visible.  It  indicates that the  TAB key will
  491.                   insert ASCII  spaces  rather than  tabs  into the  file
  492.                   buffer.  
  493.  
  494.           WR      If the Define  Wordwrap Enable command  has been given,
  495.                   this field is visible.  
  496.  
  497.  
  498.  
  499.         2.8.4  The File Windows  
  500.  
  501.         The area between  the status  line and the  bottom of  the screen
  502.         displays the text of the file  buffer(s) being edited.  This area
  503.         may contain one or  two windows.  If  two windows are  in use the
  504.         screen is divided by a line of hyphens.  
  505.  
  506.  
  507.  
  508.         2.9  Moving the Cursor  
  509.  
  510.         The editor uses a  blinking cursor to identify  the region in the
  511.         file buffer around which  editing takes place.   The keyboard has
  512.         several keys that  move the cursor.   The four keys  with arrows,
  513.         LEFT, RIGHT,  UP, and  DOWN,  move the  cursor  in the  indicated
  514.         directions.  The cursor can only be  moved to areas on the screen
  515.         where text (or space characters) is displayed.  
  516.  
  517.         The last characters on each line,  with the exception of the last
  518.         line in the file buffer, are a carriage return followed by a line
  519.         feed (CRLF).  Both of these characters are inserted into the file
  520.         buffer when you  press the RETURN  key while in  the INSERT mode.
  521.         These characters are not  displayed, and in many  ways the editor
  522.  
  523.  
  524.  
  525.         (E.Y.G.)                      - 7 -             (printed 4-18-86)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  532.  
  533.  
  534.  
  535.         treats them as  a single character.   If the cursor  is placed to
  536.         the right of the last character on a line, it is considered to be
  537.         at the position of the  CRLF.  If you attempt  to move the cursor
  538.         to the  right of  this position,  the cursor  moves to  the first
  539.         character of the next  line.  If you press  the DELETE CHAR (DEL)
  540.         key while the cursor is  at the end of a  line, both the carriage
  541.         return and the  line feed are  deleted from the  file buffer, and
  542.         the next line is moved up and appended to the current line.  
  543.  
  544.         The editor has  automatic scrolling,  meaning the  displayed text
  545.         automatically shifts horizontally and vertically  when you try to
  546.         move the cursor past the limits  of the display window.  When you
  547.         scroll vertically using the UP or  DOWN keys, the cursor attempts
  548.         to maintain the  same column position  on each new  line.  If you
  549.         move the cursor  to a  short line  which does  not extend  to the
  550.         cursor's current column, the cursor temporarily shifts columns to
  551.         the end of the  short line.  If the  cursor is subsequently moved
  552.         to a longer line, it returns to its original column.  
  553.  
  554.         The displayed text can be rolled  up or down without changing the
  555.         cursor's position within the file buffer.   This is done by hold-
  556.         ing down  the SHIFT  key and  pressing  UP or  DOWN.  The  cursor
  557.         remains at its character  position until it bumps  into the upper
  558.         or lower boundary of the window.  
  559.  
  560.         The cursor can  be moved directly  to the  beginning or end  of a
  561.         line by holding down the SHIFT key and pressing the LEFT or RIGHT
  562.         cursor key.  
  563.  
  564.         The cursor can be moved to the  beginning of the next or previous
  565.         word using the CTRL and RIGHT or LEFT cursor keys.  
  566.  
  567.         The cursor can  be moved through  the file  in steps of  nearly a
  568.         full window  of text  by using  the PREV  (PgUp) and  NEXT (PgDn)
  569.         keys.  
  570.  
  571.         The cursor can  be moved directly  to the first  character in the
  572.         file buffer using the HOME key, and  to the last character in the
  573.         file buffer using the SHIFT and HOME keys (END key, unshifted, on
  574.         an IBM PC).  
  575.  
  576.  
  577.  
  578.         2.10  The Marker  
  579.  
  580.         A number of  commands operate on  blocks of text.   These include
  581.         moving, copying,  deleting, filling,  justifying, printing,  case
  582.         conversion, and space and tab conversion.   A block is a consecu-
  583.         tive group of  characters identified by  a beginning and  an end.
  584.         To identify a  block of text  you must first  specify a position,
  585.         called the marker,  at the  beginning of the  block.  To  do this
  586.         move the cursor to the first character  of the block and give the
  587.         command Define Marker.  Thereafter the  cursor itself serves as a
  588.  
  589.  
  590.  
  591.         (E.Y.G.)                      - 8 -             (printed 4-18-86)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  598.  
  599.  
  600.  
  601.         pointer to the end  of the block.   The block is  the region from
  602.         the marker up to  but not including the  character above the cur-
  603.         sor.  
  604.  
  605.         The marker is  not a character  and cannot  be deleted.  It  is a
  606.         pointer to a position in the  file buffer.  If characters are in-
  607.         serted or deleted before the  marker, the marker remains pointing
  608.         to the  same character.   If  the character  that  the marker  is
  609.         pointing to is deleted,  the marker shifts to  the right to point
  610.         to the next character in the file buffer.  
  611.  
  612.         Whenever a file is  read into a  file buffer, the  marker is ini-
  613.         tialized to point to the first character in the file buffer.  
  614.  
  615.  
  616.  
  617.  
  618.         2.11  Saving the File Buffer  
  619.  
  620.         The editor has two  commands that save the  file buffer under the
  621.         same name as the  input file.  File Update  saves the file buffer
  622.         and returns to the edit mode, while File Save+exit saves and then
  623.         exits the current file  buffer.  If two file  buffers are in use,
  624.         File Save+exit releases  the memory used  by the saved  buffer to
  625.         the free space pool and displays  the other file buffer.  If only
  626.         a single file buffer is in use, the editor exits to MS-DOS.  
  627.  
  628.         With either command the following actions occur: 
  629.  
  630.           1.  If the buffer holds a new file that has not yet been named,
  631.               you are prompted for a filename.  
  632.  
  633.           2.  If a backup file exists with the same prefix as the file to
  634.               be saved and an extension of ".BAK", that file is deleted.  
  635.  
  636.           3.  If the filename to be saved  already exists on the disk, it
  637.               is renamed with an extension of ".BAK".  
  638.  
  639.           4.  The current file buffer is written to the disk.  
  640.  
  641.  
  642.  
  643.         2.12  Editor Configuration Files  
  644.  
  645.         A means is  provided of saving  the state  of many of  the editor
  646.         parameters in a disk file, and  of having that file automatically
  647.         read and used to initialize the editor when a file is read into a
  648.         file buffer.  The editor parameters  that are saved in configura-
  649.         tion files are  those set by  the Define commands,  which include
  650.         case sensitivity, use-tabs/no-tabs, tab stops, paragraph margins,
  651.         and wordwrap enable/disable.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.         (E.Y.G.)                      - 9 -             (printed 4-18-86)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  664.  
  665.  
  666.  
  667.         For example, your system can  be configured to automatically turn
  668.         on wordwrap  and  set paragraph  margins  whenever files  with  a
  669.         filename extension  of ".DOC"  or ".TXT"  are read,  and to  turn
  670.         those wordprocessing functions off  and set tabs  stops and other
  671.         functions a different way  whenever a filename  with an extension
  672.         of ".C" is  read.  A different  configuration file can  exist for
  673.         each unique filename extension.  Using a standard MS-DOS command,
  674.         you can specify in which directory these configuration files will
  675.         be written.  By including this  command in the AUTOEXEC.BAT batch
  676.         file, it can be invoked every time the computer is turned on.  
  677.  
  678.  
  679.  
  680.  
  681.         2.12.1  Enabling Configuration Files  
  682.  
  683.         To enable the use of configuration files, a parameter must be set
  684.         in the MS-DOS  environment string.  MS-DOS  maintains an environ-
  685.         ment string in which  parameters can be defined,  either from the
  686.         MS-DOS command line, or  from batch files, and  which can be read
  687.         by application programs such  as the editor.   The MS-DOS command
  688.         to insert or delete  a parameter in the  environment is SET.  The
  689.         SET command, given without parameters,  displays the current con-
  690.         tents of the environment.   Given with parameters, it  is used to
  691.         insert, change or delete a parameter.  
  692.  
  693.         The editor  searches the  environment for  a string  of the  form
  694.         "EDCONFIG=<dir>", where <dir> is the  name of the directory where
  695.         the configuration  files are  kept.  For  example, to  enable the
  696.         editor to use configuration files in the directory A:\UTILS, give
  697.         the following command: 
  698.  
  699.               A>SET EDCONFIG=A:\UTILS 
  700.  
  701.         The association of configuration  files with the  files which are
  702.         edited is by filename  extension.  When a disk  file is read into
  703.         the   editor's   file    buffer,   and    a   string    such   as
  704.         "EDCONFIG=A:\UTILS" is found in the environment, the editor sear-
  705.         ches the  specified directory  (in this  example A:\UTILS)  for a
  706.         file with a filename  prefix of "EDCONFIG" and  a filename exten-
  707.         sion which  is  the  same as  that  of  the file  to  be  edited.
  708.         Continuing the example, if you begin editing the file "TEST.PAS",
  709.         the editor attempts to open  the file "A:\UTILS\EDCONFIG.PAS" and
  710.         uses it to initialize the editing  environment of that file buff-
  711.         er.  
  712.  
  713.  
  714.  
  715.         2.12.2  Writing a Configuration File  
  716.  
  717.         To write  a configuration  file, give  the command  File Profile.
  718.         The current state  of the  editor will be  save in  the directory
  719.         named in the MS-DOS environment.  
  720.  
  721.  
  722.  
  723.         (E.Y.G.)                     - 10 -             (printed 4-18-86)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  730.  
  731.  
  732.  
  733.         2.12.3  Disabling Configuration Files  
  734.  
  735.         To delete a string  from the the MS-DOS  environment, use the SET
  736.         command and  enter only  the left  hand portion  of the  existing
  737.         string up to  and including  the equal sign  (=).  In  this case,
  738.         give the command 
  739.  
  740.               A> SET EDCONFIG= 
  741.  
  742.         With the  "EDCONFIG=<DIR>" string  removed from  the environment,
  743.         existing editor configuration files will be ignored, and new con-
  744.         figuration files cannot be written (with File Profile).  
  745.  
  746.  
  747.  
  748.  
  749.         3.  GENERAL REFERENCE  
  750.  
  751.         This section serves as  a reference to the  editor's commands and
  752.         special editing  keys.  Included  is a  section on  ASCII control
  753.         characters which have special meaning within the editor.  
  754.  
  755.  
  756.  
  757.         3.1  Special Editing Keys  
  758.  
  759.         This section describes  keys that  perform special  editing func-
  760.         tions.  As in  the other  chapters, the keys  are referred  to by
  761.         their labels on  the HP150 keyboard.   If the IBM  keyboard has a
  762.         different label, the IBM label is shown in parentheses.  
  763.  
  764.         A few of the keys perform functions during command entry, and are
  765.         noted as such.  
  766.  
  767.  
  768.  
  769.         3.1.1  ESCAPE (or F8)  
  770.  
  771.         In the edit  mode, this  key begins a  command.  The  first level
  772.         command choices  are then  displayed  on the  first  line on  the
  773.         screen.  Pressing this key while in the command tree backs up one
  774.         step to the previous command keyword.  
  775.  
  776.         As a convenience to users who are burdened with an inappropriate-
  777.         ly positioned ESCAPE key  (e.g.  Vectra), the F8  function key is
  778.         also bound to the escape funtion.  
  779.  
  780.  
  781.  
  782.         3.1.2  CLEAR LINE (SHIFT-END)  
  783.  
  784.         Delete text from the cursor to  end of the line.  The end-of-line
  785.         terminators, a carriage  return followed  by a line  feed (CRLF),
  786.  
  787.  
  788.  
  789.         (E.Y.G.)                     - 11 -             (printed 4-18-86)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  796.  
  797.  
  798.  
  799.         are not  deleted.   A deleted  line  can  be restored  using  the
  800.         Undelete command.  
  801.  
  802.  
  803.  
  804.         3.1.3  DELETE LINE (SHIFT-DEL)  
  805.  
  806.         Delete the  current  line,  including  the  CRLF  terminator.   A
  807.         deleted line can be restored using the Undelete command.  
  808.  
  809.  
  810.  
  811.         3.1.4  DELETE CHAR (DEL)  
  812.  
  813.         Delete the character at the cursor position.  
  814.  
  815.  
  816.  
  817.         3.1.5  INSERT CHAR (INS)  
  818.  
  819.         Toggle between INSERT and REPLACE modes.  
  820.  
  821.  
  822.  
  823.         3.1.6  INSERT LINE (SHIFT-INS)  
  824.  
  825.         Insert an empty new line (CRLF) before the current line.  
  826.  
  827.  
  828.  
  829.         3.1.7  HOME  
  830.  
  831.         In the  edit mode,  this key  positions the  cursor at  the first
  832.         character in the file buffer.  In the command mode, it highlights
  833.         the first command keyword on the command line.  
  834.  
  835.  
  836.  
  837.         3.1.8  SHIFT-HOME (END)  
  838.  
  839.         In the edit  mode, this  key positions the  cursor past  the last
  840.         character in the file buffer.  In the command mode, it highlights
  841.         the last command keyword on the command line.  
  842.  
  843.  
  844.  
  845.         3.1.9  UP  
  846.  
  847.         Move the cursor up to the previous line.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.         (E.Y.G.)                     - 12 -             (printed 4-18-86)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  862.  
  863.  
  864.  
  865.         3.1.10  DOWN  
  866.  
  867.         Move the cursor down to the next line.  
  868.  
  869.  
  870.  
  871.         3.1.11  LEFT  
  872.  
  873.         In the  edit mode,  this key  moves the  cursor to  the left  one
  874.         character.  In the command  mode, it moves  the command highlight
  875.         one keyword to the left.  
  876.  
  877.  
  878.  
  879.         3.1.12  RIGHT  
  880.  
  881.         In the edit  mode, this  key moves  the cursor  to the  right one
  882.         character.  In the command  mode, it moves  the command highlight
  883.         one keyword to the right.  
  884.  
  885.  
  886.  
  887.         3.1.13  SHIFT-UP  
  888.  
  889.         Scroll the screen up one line.  
  890.  
  891.  
  892.  
  893.         3.1.14  SHIFT-DOWN  
  894.  
  895.         Scroll the screen down one line.  
  896.  
  897.  
  898.  
  899.         3.1.15  SHIFT-LEFT  
  900.  
  901.         Position the cursor at the beginning of the line.  
  902.  
  903.  
  904.  
  905.         3.1.16  SHIFT-RIGHT  
  906.  
  907.         Position the cursor at the end of the line.  
  908.  
  909.  
  910.  
  911.         3.1.17  CTRL-LEFT  
  912.  
  913.         Position the cursor at the start of the previous word.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.         (E.Y.G.)                     - 13 -             (printed 4-18-86)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  928.  
  929.  
  930.  
  931.         3.1.18  CTRL-RIGHT  
  932.  
  933.         Position the cursor at the start of the next word.  
  934.  
  935.  
  936.  
  937.         3.1.19  PREV (PgUp)  
  938.  
  939.         Move the cursor nearly one full  window of text toward the begin-
  940.         ning of the file buffer.  
  941.  
  942.  
  943.  
  944.         3.1.20  NEXT (PgDn)  
  945.  
  946.         Move the cursor nearly one full window  of text toward the end of
  947.         the file buffer.  
  948.  
  949.  
  950.  
  951.         3.1.21  CAPS (CAPS LOCK)  
  952.  
  953.         Toggle the uppercase lock  function on and off.   When this func-
  954.         tion is on, the status line displays  the word CAPS, and the case
  955.         of the alpha keys is reversed from normal.  Unshifted letters are
  956.         entered as  capitals, and  shifted letters  are entered  as lower
  957.         case.  
  958.  
  959.  
  960.  
  961.         3.1.22  RETURN  
  962.  
  963.         In the edit INSERT  mode, this key  causes a CRLF  to be inserted
  964.         into the file  buffer.  In the  edit REPLACE mode,  the cursor is
  965.         moved to the beginning  of the next line,  and characters are not
  966.         inserted into the file buffer unless the cursor was positioned at
  967.         the last  character in  the file.   During command  entry, RETURN
  968.         selects the currently  highlighted keyword, and  is equivalent to
  969.         pressing the  key corresponding  to the  first character  in that
  970.         keyword.  
  971.  
  972.  
  973.  
  974.         3.1.23  BACKSPACE  
  975.  
  976.         Delete the character to the left of the cursor.  
  977.  
  978.  
  979.  
  980.         3.1.24  TAB  
  981.  
  982.         In the REPLACE  mode, this key  positions the cursor  at the next
  983.         defined tab stop.   In the INSERT  mode, this key  either inserts
  984.  
  985.  
  986.  
  987.         (E.Y.G.)                     - 14 -             (printed 4-18-86)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  994.  
  995.  
  996.  
  997.         the ASCII tab character in the file buffer, or inserts the number
  998.         of spaces required to move the cursor  to the next tab stop.  The
  999.         commands Define No-tabs and Define Use-tabs control which charac-
  1000.         ter is inserted.  
  1001.  
  1002.  
  1003.  
  1004.         3.2  Control Characters  
  1005.  
  1006.         Control characters are special  codes in the  ASCII character set
  1007.         that control  devices  such  as  printers,  modems,  etc.   These
  1008.         characters have  ASCII  codes  from  0 to  31  decimal.   Control
  1009.         characters can be  entered into the  file buffer by  holding down
  1010.         the CTRL key and striking an alpha key.  
  1011.  
  1012.         With a few exceptions,  control characters are  displayed as spe-
  1013.         cial graphics  characters.  Consult  your computer  user's manual
  1014.         for a description of the complete character set.  
  1015.  
  1016.         All the control characters, with the exception of space, tab, and
  1017.         the CRLF sequence,  are treated  as zero-width characters  by the
  1018.         Block Fill and Block  Justify commands.  This  allows the correct
  1019.         formatting of  paragraphs that  contain control  characters which
  1020.         will later be expanded into printer  control sequences by a print
  1021.         formatter program (Wordstar, for example).  
  1022.  
  1023.         Several of these codes have special meaning within the editor: 
  1024.  
  1025.  
  1026.  
  1027.         3.2.1  Substitute (CTRL-Z)  
  1028.  
  1029.         This code is used by  both MS-DOS and the editor  to mark the end
  1030.         of a file.   It cannot be  inserted into  a file buffer  from the
  1031.         keyboard.  When a file buffer is  written to a disk, this charac-
  1032.         ter is appended to the file.  
  1033.  
  1034.  
  1035.  
  1036.         3.2.2  Carriage Return (CTRL-M)  
  1037.  
  1038.         If this character is followed immediately in the file buffer by a
  1039.         line feed (CTRL-J),  the pair marks  the end of  a line.  Neither
  1040.         character is then displayed and subsequent characters in the file
  1041.         buffer are displayed on  the next line.  If  a carriage return is
  1042.         followed by any character other than a line feed, it is displayed
  1043.         as a special graphics character, and subsequent characters in the
  1044.         file buffer are displayed on the  same line.  When the RETURN key
  1045.         is pressed in the edit INSERT mode,  a carriage return and a line
  1046.         feed (CRLF) are inserted into the file buffer.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.         (E.Y.G.)                     - 15 -             (printed 4-18-86)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1060.  
  1061.  
  1062.  
  1063.         3.2.3  Line Feed (CTRL-J)  
  1064.  
  1065.         If this character is preceeded immediately  in the file buffer by
  1066.         a carriage return  (CTRL-M), the  pair marks the  end of  a line.
  1067.         Neither character is then displayed  and subsequent characters in
  1068.         the file buffer are displayed  on the next line.   If a line feed
  1069.         is preceeded by any character other than a carriage return, it is
  1070.         displayed as a special graphics character, and subsequent charac-
  1071.         ters in the file buffer are displayed on the same line.  When the
  1072.         RETURN key is pressed in the  edit INSERT mode, a carriage return
  1073.         and a line feed (CRLF) are inserted into the file buffer.  
  1074.  
  1075.  
  1076.  
  1077.         3.2.4  Escape (CTRL-[)  
  1078.  
  1079.         This code can be entered  into a file buffer  by holding down the
  1080.         CTRL key and pressing  the key with the  left bracket symbol ([).
  1081.         This is not to be confused with the ESC key, which does not enter
  1082.         an escape character into the file buffer,  but is used to begin a
  1083.         command or back up out of the command tree.  
  1084.  
  1085.  
  1086.  
  1087.         3.2.5  Backspace (CTRL-H)  
  1088.  
  1089.         This character can  be inserted  in the file  buffer and  is dis-
  1090.         played as a special graphics character.  The BACKSPACE key on the
  1091.         keyboard does not insert this character into the file buffer, but
  1092.         instead performs an editing function  described elsewhere in this
  1093.         chapter.  
  1094.  
  1095.  
  1096.  
  1097.         3.2.6  Tab (CTRL-I)  
  1098.  
  1099.         The tab character is used  in text files to  save space by repre-
  1100.         senting a variable number  of spaces.  The editor  permits you to
  1101.         define the columns at which tab stops occur.  When the file buff-
  1102.         er is displayed,  tab characters  are expanded  on the  screen so
  1103.         that the correct  format of the  text is seen.   The area between
  1104.         the tab characters and  the next tab stop  appears as blank space
  1105.         on the screen.  This  area cannot be edited  and the cursor skips
  1106.         over it.  
  1107.  
  1108.         Tabs can be inserted into the file  buffer using the TAB key.  If
  1109.         the command Define No-tabs  has been given, the  keyboard TAB key
  1110.         causes ASCII spaces to be inserted  into the file buffer in place
  1111.         of tab characters.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.         (E.Y.G.)                     - 16 -             (printed 4-18-86)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1126.  
  1127.  
  1128.  
  1129.         3.3  Commands  
  1130.  
  1131.         The following  commands are  begun  by pressing  the ESCAPE  key.
  1132.         Commands are entered by giving the first character of the command
  1133.         keywords.  
  1134.  
  1135.  
  1136.  
  1137.         3.3.1  Adjust  
  1138.  
  1139.         This command is  used to change  the indentation of  lines in the
  1140.         file buffer.  While invoked,  the four cursor  control arrow keys
  1141.         are temporarily redefined to control  this indentation.  The LEFT
  1142.         and RIGHT arrow keys shift the entire current line to the left or
  1143.         right.  The message line displays the  number of columns that the
  1144.         current line has been shifted.  A shift toward the left margin is
  1145.         displayed as a negative number.  
  1146.  
  1147.         The UP and  DOWN arrow keys  move the  cursor to the  previous or
  1148.         next line and shift the new  line the number of columns displayed
  1149.         on the message line.   Thus a number of  consecutive lines can be
  1150.         easily shifted by the same offset.  
  1151.  
  1152.         The Adjust command is terminated by pressing the ESCAPE key.  
  1153.  
  1154.         The Adjust command performs its shifting by inserting or deleting
  1155.         leading spaces and  tabs.  If the  Define Use-tabs command  is in
  1156.         effect (the default  condition), leading spaces  on each adjusted
  1157.         line will be consolidated into tab characters wherever it is pos-
  1158.         sible  to  so  (by  the  same   rules  followed  by  the  Convert
  1159.         Spaces->tabs command).  
  1160.  
  1161.  
  1162.  
  1163.         3.3.2  Block Append  
  1164.  
  1165.         Add the text between the marker and  the cursor to the end of the
  1166.         block buffer.  The size of the block buffer is expanded to accom-
  1167.         modate the additional text.   The text in the  file buffer is not
  1168.         changed.  
  1169.  
  1170.  
  1171.  
  1172.         3.3.3  Block Copy  
  1173.  
  1174.         Copy the text  between the marker  and the cursor  into the block
  1175.         buffer.  Any previous contents of  the block buffer are overwrit-
  1176.         ten.  The text in the file buffer is not changed.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.         (E.Y.G.)                     - 17 -             (printed 4-18-86)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1192.  
  1193.  
  1194.  
  1195.         3.3.4  Block Delete  
  1196.  
  1197.         Delete the text between  the marker and the  cursor from the file
  1198.         buffer, and move it into the block buffer.  The previous contents
  1199.         of the block buffer are overwritten.  
  1200.  
  1201.  
  1202.  
  1203.         3.3.5  Block Fill  
  1204.  
  1205.         Format a group of lines,  from the line pointed  to by the marker
  1206.         to the current line, into paragraphs so that all enclosed text is
  1207.         contained within the  paragraph margins.   As many words  as pos-
  1208.         sible are  packed onto  each line  using a  single space  between
  1209.         words, and two spaces following words that end with a period (.),
  1210.         exclamation mark (!), or question mark (?).  
  1211.  
  1212.         A line following a blank line  is interpreted as the beginning of
  1213.         a new paragraph, and its left margin  is set to the value defined
  1214.         as the paragraph  margin.  The first  line in the  blocked region
  1215.         (the line to which the marker points)  is assumed to be the first
  1216.         line of a  paragraph and  is also  indented to  the value  of the
  1217.         paragraph margin.  
  1218.  
  1219.  
  1220.  
  1221.         3.3.6  Block Insert  
  1222.  
  1223.         Insert the text held in the block  buffer into the file buffer at
  1224.         the cursor position.  The block buffer is not changed.  
  1225.  
  1226.  
  1227.  
  1228.         3.3.7  Block Justify  
  1229.  
  1230.         This command performs all the actions  of the Block Fill command,
  1231.         then adds  additional  spaces  between  words so  that  the  last
  1232.         character on each formatted line is  flush with the right margin.
  1233.         This gives formatted text a more formal appearance.  
  1234.  
  1235.  
  1236.  
  1237.         3.3.8  Block Print  
  1238.  
  1239.         Print the text  between the marker  and the cursor.   The text is
  1240.         sent to the primary  MS-DOS printer (otherwise  identified as the
  1241.         PRN or LPT1 device).  The  text is sent exactly  as it appears in
  1242.         the file buffer, except that tab characters are expanded into the
  1243.         appropriate number of ASCII spaces.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.         (E.Y.G.)                     - 18 -             (printed 4-18-86)
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1258.  
  1259.  
  1260.  
  1261.         3.3.9  Block Write  
  1262.  
  1263.         Write the text between the marker and  the cursor to a disk file.
  1264.         Invoking this command causes the editor to prompt for a filename.
  1265.         If the file  you specify already  exists, its contents  are over-
  1266.         written with the text from the indicated region of the file buff-
  1267.         er.  If  the file  does not  exit it  is created  in the  current
  1268.         directory.  The text in the file buffer is not changed.  
  1269.  
  1270.  
  1271.  
  1272.         3.3.10  Convert Lowercase->uppercase  
  1273.  
  1274.         Convert all alpha characters between the marker and cursor to up-
  1275.         percase.  
  1276.  
  1277.  
  1278.  
  1279.         3.3.11  Convert Spaces->tabs  
  1280.  
  1281.         Convert ASCII space  characters to tabs  in the text  between the
  1282.         marker and the cursor.  The appearance  of the file buffer in the
  1283.         display window remains  unchanged, but  the file buffer  size can
  1284.         decrease significantly.  The conversion is done as follows: 
  1285.  
  1286.           1.  If two or  more consecutive  spaces directly preceed  a tab
  1287.               stop column,  those spaces  are  replaced by  a single  tab
  1288.               character.  
  1289.  
  1290.           2.  If one or more consecutive spaces do not directly preceed a
  1291.               tab stop column, but are followed by a tab character, those
  1292.               spaces are deleted.  
  1293.  
  1294.           3.  Spaces within  literal  strings  are  not  converted.   All
  1295.               spaces following a  single or  double quote character  on a
  1296.               line remain unchanged.  
  1297.  
  1298.  
  1299.  
  1300.         3.3.12  Convert Tabs->spaces  
  1301.  
  1302.         Convert tab characters to  the equivalent number  of ASCII spaces
  1303.         in the text between the marker and the cursor.  The appearance of
  1304.         the file buffer in the display  window remains unchanged, but its
  1305.         size can  increase significantly.   This command  can be  used to
  1306.         "freeze" the format of  a file buffer  containing tab characters,
  1307.         making the spacings in  the buffer independent of  changes in tab
  1308.         stop  definitions,  or  of   different  interpretation  by  other
  1309.         programs.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.         (E.Y.G.)                     - 19 -             (printed 4-18-86)
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1324.  
  1325.  
  1326.  
  1327.         3.3.13  Convert Uppercase->lowercase  
  1328.  
  1329.         Convert all alpha characters  in the text between  the marker and
  1330.         the cursor to lowercase.  
  1331.  
  1332.  
  1333.  
  1334.         3.3.14  Define Case  
  1335.  
  1336.         Make the Replace and Search commands sensitive to the case of the
  1337.         target string.  When this command is in effect, the case of alpha
  1338.         characters in the search  string must agree with  the case of the
  1339.         the characters  in the  file buffer  for a  match to  occur.  The
  1340.         status line displays a highlighted "CA"  when this command is ac-
  1341.         tive.  
  1342.  
  1343.  
  1344.  
  1345.         3.3.15  Define Ignore  
  1346.  
  1347.         Ignore the  case  of alpha  characters  during the  execution  of
  1348.         Replace and Search  commands.  This  is the default  operation of
  1349.         the editor.  When  this command is  in effect, the  case of alpha
  1350.         characters in the search string can be different from the case of
  1351.         characters in the file workspace, and a match can still exist.  
  1352.  
  1353.  
  1354.  
  1355.         3.3.16  Define Marker  
  1356.  
  1357.         Define the marker to  point to the character  at the cursor loca-
  1358.         tion.  The marker is not  a character itself, but  a pointer to a
  1359.         location in the  file buffer.  It  is not visible,  and cannot be
  1360.         displayed.  It is used to mark the  beginning of a region of text
  1361.         to be operated on  by another command,  or to mark  a location in
  1362.         the file buffer  that can  be easily returned  to using  the Jump
  1363.         Marker command.  When  a file is  read into the  file buffer, the
  1364.         marker is  initialized to  point to  the first  character in  the
  1365.         buffer.  
  1366.  
  1367.  
  1368.  
  1369.         3.3.17  Define No-tabs  
  1370.  
  1371.         Define the operation of the TAB key such that ASCII space charac-
  1372.         ters, instead  of a  tab character,  are inserted  into the  file
  1373.         buffer when  this key  is pressed.   The status  line displays  a
  1374.         highlighted "SP" when this command is in effect.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.         (E.Y.G.)                     - 20 -             (printed 4-18-86)
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1390.  
  1391.  
  1392.  
  1393.         3.3.18  Define Paragraph  
  1394.  
  1395.         Define the  margins used  for paragraph  formatting and  wordwrap
  1396.         operation.  This command allows you to  enter new values used for
  1397.         the left margin,  the right margin,  and the margin  used for the
  1398.         first line of  each new  paragraph (paragraph indent).   When in-
  1399.         voked, the current  values are displayed,  and one, two  or three
  1400.         new values  can  be  entered.   Since  it  is  quite  common  for
  1401.         paragraphs to be formatted with the paragraph indent equal to the
  1402.         left margin, the following rules apply: 
  1403.  
  1404.            -  If a single new value  is entered, it is  used for both the
  1405.               left margin and the paragraph  indent, and the right margin
  1406.               remains unchanged.  
  1407.  
  1408.            -  If two values are entered, the first value is used for both
  1409.               the left margin and the paragraph indent, and the second is
  1410.               used for the new right margin.  
  1411.  
  1412.            -  If three values are entered,  all three margins are changed
  1413.               independently.  
  1414.  
  1415.  
  1416.  
  1417.         3.3.19  Define Tabs Fixed  
  1418.  
  1419.         Define a fixed interval for tab  stops.  When this command is in-
  1420.         voked, the previous tab interval is displayed.  If the RETURN key
  1421.         is pressed immediately,  the tab interval  will remain unchanged.
  1422.         To change the  fixed tab interval,  enter a number  between 2 and
  1423.         100, then press RETURN.  The default tab interval is 8 (tab stops
  1424.         every 8 columns, beginning in column 9).  
  1425.  
  1426.  
  1427.  
  1428.         3.3.20  Define Tabs Variable  
  1429.  
  1430.         Define tab stops at individual columns.  When this command is in-
  1431.         voked, you are prompted to enter a list of column numbers.  Enter
  1432.         the tab stops as  a list of numbers  in the range from  1 to 255,
  1433.         separated by  commas or  spaces, then  press RETURN.   The column
  1434.         numbers may be  entered in  any numeric  order.  Note  that lines
  1435.         within the  editor can  be as  long as  1000 characters,  but in-
  1436.         dividual tab stops can only be defined for the first 255 columns.
  1437.         Example: 
  1438.  
  1439.               Enter tab columns: 13,35,75 
  1440.  
  1441.         The example shows  tab stops defined  for three columns.   If the
  1442.         tab key is pressed  and the cursor  is past column 74  on a line,
  1443.         the cursor  will move  to column  13 on  the next  line.  In  the
  1444.         INSERT mode, this would insert CRLF and either a tab or 12 spaces
  1445.         into the file workspace.  
  1446.  
  1447.  
  1448.  
  1449.         (E.Y.G.)                     - 21 -             (printed 4-18-86)
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1456.  
  1457.  
  1458.  
  1459.         3.3.21  Define Use-tabs  
  1460.  
  1461.         Define the operation of the TAB key so that ASCII tab characters,
  1462.         instead of the equivalent  number of spaces, are  inserted in the
  1463.         file buffer when the key is  pressed.  This is the default opera-
  1464.         tion of the editor.  
  1465.  
  1466.  
  1467.  
  1468.         3.3.22  Define Wordwrap Disable  
  1469.  
  1470.         This command  disables the  wordwrap  typing mode.   This is  the
  1471.         default operation of the editor.  
  1472.  
  1473.  
  1474.  
  1475.         3.3.23  Define Wordwrap Enable  
  1476.  
  1477.         This command enables the wordwrap  typing mode.  This mode allows
  1478.         text to  be entered  without concern  for ending  lines with  the
  1479.         RETURN key.  After  every character  other than  space or  tab is
  1480.         entered, the column number of the cursor is compared to the right
  1481.         margin.  If the new character caused  a word to extend beyond the
  1482.         right margin, a CRLF is inserted after the previous word, and the
  1483.         current word is moved to  the next line and  indented to the left
  1484.         margin.  
  1485.  
  1486.         If the RETURN  key is pressed  with wordwrap enabled,  the cursor
  1487.         moves to the left margin column on the following line.  
  1488.  
  1489.         A highlighted  "WR"  is displayed  on  the status  line  whenever
  1490.         wordwrap is enabled.  
  1491.  
  1492.  
  1493.  
  1494.         3.3.24  File Command  
  1495.  
  1496.         Temporarily exit to MS-DOS from  within the editor.  This command
  1497.         allows you  to invoke  MS-DOS commands  and run  programs without
  1498.         quitting the editor.  When this command is invoked, the operation
  1499.         of the  editor is  temporarily suspended,  and the  shell program
  1500.         specified by the "COMSPEC="  parameter in the  environment is ex-
  1501.         ecuted.  On most systems this  program is COMMAND.COM, the MS-DOS
  1502.         command parser.  
  1503.  
  1504.         To return  to the  editor,  give the  MS-DOS  EXIT command.   All
  1505.         editor parameters,  including the  contents of  all buffers,  the
  1506.         screen display, and cursor position, will be exactly as they were
  1507.         before File Command was  invoked.  In addition,  the current disk
  1508.         and current directory are restored to their previous values.  
  1509.  
  1510.         File Command will not execute if  there is insufficient memory to
  1511.         execute the shell,  if there  is no  "COMSPEC=" parameter  in the
  1512.  
  1513.  
  1514.  
  1515.         (E.Y.G.)                     - 22 -             (printed 4-18-86)
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1522.  
  1523.  
  1524.  
  1525.         environment, or  if the  shell  program cannot  be  found in  the
  1526.         specified drive and directory.  
  1527.  
  1528.  
  1529.  
  1530.         3.3.25  File Edit  
  1531.  
  1532.         Abandon the current contents of the  active file buffer and begin
  1533.         editing another file  in the  same buffer.   You are  prompted to
  1534.         enter a disk filename.  If the file that you specify is found, it
  1535.         is read into the  file buffer.  If  the file is not  found on the
  1536.         disk, a new  file is created,  and an  empty file buffer  is dis-
  1537.         played.  
  1538.  
  1539.  
  1540.  
  1541.         3.3.26  File Merge  
  1542.  
  1543.         Merge the contents  of a disk  file into  the file buffer  at the
  1544.         cursor location.  You  are prompted  for the  name of  the source
  1545.         file.  The source file is not altered.  
  1546.  
  1547.  
  1548.  
  1549.         3.3.27  File Other  
  1550.  
  1551.         Create a second file buffer  if only one is in  use, or switch to
  1552.         the other file  buffer if two  buffers are  in use.  If  only one
  1553.         file buffer is in use,  you are prompted for  the name of another
  1554.         disk file.  If  the file that  you specify  is found, it  is read
  1555.         into a newly created  file buffer.  If  the file is  not found on
  1556.         the disk, a new file is created, and an empty file buffer is dis-
  1557.         played.  
  1558.  
  1559.         When two file buffers are  in use, each buffer  has its own inde-
  1560.         pendent definitions  of marker,  tabs, case/ignore,  margins, and
  1561.         wordwrap enable/disable.  The  block buffer and  the deleted line
  1562.         buffer are common to both file buffers, allowing text to be moved
  1563.         or copied between them.  
  1564.  
  1565.  
  1566.  
  1567.         3.3.28  File Profile  
  1568.  
  1569.         Save the state of  tabs and other "Defined"  parameters in a con-
  1570.         figuration file.  To use  this command, a  parameter must already
  1571.         be SET in the MS-DOS environment, naming the directory where con-
  1572.         figuration files  will  be  read and  written.   The  environment
  1573.         parameter should have the form 
  1574.  
  1575.               EDCONFIG=<dir>
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.         (E.Y.G.)                     - 23 -             (printed 4-18-86)
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1588.  
  1589.  
  1590.  
  1591.         where  <dir>  is  a  disk  directory  name.   When  written,  the
  1592.         configuration file will have the format 
  1593.  
  1594.               <dir>\EDCONFIG.<ext>
  1595.  
  1596.         <ext> is the file  extension of the filename  associated with the
  1597.         currently active file buffer.   Configuration files are discussed
  1598.         in a previous section of this manual.  
  1599.  
  1600.  
  1601.  
  1602.         3.3.29  File Quit  
  1603.  
  1604.         Abandon the contents of  the current file  buffer without saving.
  1605.         If a single file buffer is in use, this command causes an exit to
  1606.         MS-DOS.  If two file buffers are  in use, the current file buffer
  1607.         is abandoned and  the other file  buffer is made  active and dis-
  1608.         played.  If any changes were made  to the current buffer, you are
  1609.         asked to confirm that you wish to quit.  
  1610.  
  1611.  
  1612.  
  1613.         3.3.30  File Save+exit  
  1614.  
  1615.         Save the contents of the file buffer, then exit the buffer.  If a
  1616.         single file  buffer is  in use,  this command  causes an  exit to
  1617.         MS-DOS after the file is written to  the disk.  If two file buff-
  1618.         ers are in use, the current file  buffer is exited after the file
  1619.         is written, and the other file  buffer is displayed.  A backup of
  1620.         the original file is saved under  a filename with the same prefix
  1621.         as the original and with the extension ".BAK".  
  1622.  
  1623.  
  1624.  
  1625.         3.3.31  File Update  
  1626.  
  1627.         Write the file  buffer to  the disk and  continue editing  in the
  1628.         current buffer.  As with  File Save+exit, a backup  file is kept,
  1629.         and a configuration file may be created if certain conditions are
  1630.         met.  
  1631.  
  1632.  
  1633.  
  1634.         3.3.32  File Write  
  1635.  
  1636.         Write the current file  buffer to a disk  filename entered by the
  1637.         user.  You are  prompted for  a filename.  A  backup file  is not
  1638.         created by this command.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.         (E.Y.G.)                     - 24 -             (printed 4-18-86)
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1654.  
  1655.  
  1656.  
  1657.         3.3.33  Jump Beginning  
  1658.  
  1659.         Position the cursor  at the first  character in the  file buffer.
  1660.         This command is identical to pressing the HOME key.  
  1661.  
  1662.  
  1663.  
  1664.         3.3.34  Jump End  
  1665.  
  1666.         Position the cursor  at the  last character  in the  file buffer.
  1667.         This command is identical to pressing the SHIFT-HOME (END) key.  
  1668.  
  1669.  
  1670.  
  1671.         3.3.35  Jump Line  
  1672.  
  1673.         Position the cursor  at the beginning  of a specific  line.  Line
  1674.         numbers are computed  by counting  CRLFs starting with  the first
  1675.         line of the file buffer.  The current line number is displayed on
  1676.         the status line.  
  1677.  
  1678.  
  1679.  
  1680.         3.3.36  Jump Marker  
  1681.  
  1682.         Position the cursor at the character pointed to by the marker.  
  1683.  
  1684.  
  1685.  
  1686.         3.3.37  Replace  
  1687.  
  1688.         Search for a  target string  of characters and  conditionally re-
  1689.         place it with  a replacement string  of characters.  The  case of
  1690.         alpha characters  in  the target  string  is ignored  during  the
  1691.         search unless the Define Case command  has been given.  After you
  1692.         have entered  both strings,  the  cursor is  moved  to the  first
  1693.         matching occurrence of the target string, and you can select from
  1694.         the following command line options: 
  1695.  
  1696.         All.      Replace all occurrences from  the cursor to  the end of
  1697.                   the file buffer, then return to the edit mode.  
  1698.  
  1699.         Continue. Replace the occurrence  shown at  the cursor,  and con-
  1700.                   tinue searching.  
  1701.  
  1702.         Once.     Replace the occurrence shown at the cursor, then return
  1703.                   to the edit mode.  
  1704.  
  1705.         Skip.     Don't replace the  occurrence shown at  the cursor, but
  1706.                   continue searching for the next.  
  1707.  
  1708.         Quit.     Return to the edit mode.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.         (E.Y.G.)                     - 25 -             (printed 4-18-86)
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1720.  
  1721.  
  1722.  
  1723.         3.3.38  Search  
  1724.  
  1725.         Search for a target character string.   The case of alpha charac-
  1726.         ters in the target string is ignored during the search unless the
  1727.         Define Case command has  been given.  After the  target string is
  1728.         entered, you have the following command options: 
  1729.  
  1730.         Forward.  Search forward toward  the end  of the file  buffer for
  1731.                   the target string.  
  1732.  
  1733.         Backward. Search backward toward the beginning of the file buffer
  1734.                   for the target string.  
  1735.  
  1736.         Quit.     Quit searching and return to the edit mode.  
  1737.  
  1738.  
  1739.  
  1740.         3.3.39  Undelete  
  1741.  
  1742.         Insert at the cursor position the last line deleted by either the
  1743.         DELETE LINE or CLEAR LINE key.  
  1744.  
  1745.  
  1746.  
  1747.         3.3.40  Window 1-window  
  1748.  
  1749.         Set the screen display  to single window mode.   If the screen is
  1750.         not in 2-windows mode, the command is ignored.  
  1751.  
  1752.  
  1753.  
  1754.         3.3.41  Window 2-windows  
  1755.  
  1756.         Divide the screen display into two windows separated by a line of
  1757.         hyphens.  If the screen is already in the 2-window mode, the com-
  1758.         mand is ignored.  If two file buffers  are in use, each buffer is
  1759.         displayed in one of the  windows.  If one file  buffer is in use,
  1760.         each window displays a  portion of that buffer.   The window con-
  1761.         taining the cursor is  the active window.   The command, message,
  1762.         and status lines  display information about  the currently active
  1763.         window.  
  1764.  
  1765.  
  1766.  
  1767.         3.3.42  Window Other-window  
  1768.  
  1769.         Make the other  window active in  2-windows mode.  If  the screen
  1770.         display is in 1-window mode, the  command is ignored.  The cursor
  1771.         is moved to its previous position  in the other window.  The com-
  1772.         mand, message,  and status  lines display  information about  the
  1773.         currently active window.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.         (E.Y.G.)                     - 26 -             (printed 4-18-86)
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1786.  
  1787.  
  1788.  
  1789.         3.4  MS-DOS Command Line Switches  
  1790.  
  1791.         MS-DOS provides a means of passing the parameters that were given
  1792.         on the command line to the program  when it is invoked.  The for-
  1793.         ward slash (/) is  defined as the  switch character.  Application
  1794.         programs such as  the editor  interpret the  characters following
  1795.         the switch character as  an optional command.   The editor recog-
  1796.         nizes two  switches  that alter  the  size  of its  memory  pool.
  1797.         Another switch  allows  "document"  files created  by  some  word
  1798.         processors to be edited.  
  1799.  
  1800.  
  1801.  
  1802.         3.4.1  /a  
  1803.  
  1804.         Use all available memory for the memory pool.  The editor normal-
  1805.         ly uses 14K bytes less than the maximum available memory to avoid
  1806.         overwriting COMMAND.COM.  Examples: 
  1807.  
  1808.               A>ed /a 
  1809.               A>ed sample.pas /a 
  1810.  
  1811.  
  1812.  
  1813.         3.4.2  /d  
  1814.  
  1815.         Clear the most  significant bit  (bit 7)  of each  character read
  1816.         from a file  during the  edit session.  This  converts "document"
  1817.         files created by some word processors into standard ASCII text.  
  1818.  
  1819.  
  1820.  
  1821.         3.4.3  /m<blocks>  
  1822.  
  1823.         Use <blocks>  number of  1000-byte memory  blocks for  the memory
  1824.         pool.  This switch  is useful if  you want  to reserve a  part of
  1825.         memory that you  don't want  overwritten by  the editor.   If you
  1826.         specify a  number  less than  20,  20 blocks  are  used.  If  you
  1827.         specify a larger  number of  blocks than  are available,  all the
  1828.         available memory is used.  Examples: 
  1829.  
  1830.               A>ed /m30                    (Use 30,000 bytes)
  1831.               A>ed sample.pas /m355        (Use 355,000 bytes)
  1832.  
  1833.  
  1834.  
  1835.         3.5  Environment Parameters  
  1836.  
  1837.         The editor looks for a substring in the MS-DOS environment of the
  1838.         form "EDCONFIG=<dir>".  If such a  substring is found, the editor
  1839.         is enabled to read  and write configuration files,  which will be
  1840.         kept in the  named directory.  Configuration  files are described
  1841.         in an earlier section of this manual.  
  1842.  
  1843.  
  1844.  
  1845.         (E.Y.G.)                     - 27 -             (printed 4-18-86)
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1852.  
  1853.  
  1854.  
  1855.         When File Command is  invoked, the environment is  searched for a
  1856.         substring  of  the  form   "COMSPEC=<filespec>".   Refer  to  the
  1857.         description of this command elsewhere in this section.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.         4.  EDITING TECHNIQUES  
  1863.  
  1864.         This section gives  helpful examples  of the  use of  some editor
  1865.         commands.  Readers that are familiar with the use of text editors
  1866.         can skip this section.  
  1867.  
  1868.  
  1869.  
  1870.         4.1  Defining a Block  
  1871.  
  1872.         Many commands  operate on  a  group of  characters  defined as  a
  1873.         block.  A block can be part of a line, a few lines, or the entire
  1874.         file.  A block is defined by the following steps: 
  1875.  
  1876.           1.  Move the cursor to the first character in the block.  
  1877.  
  1878.           2.  Execute the command Define Marker.  
  1879.  
  1880.           3.  Now move the cursor to the  first character past the end of
  1881.               the block.  If  you want the  block to include  a CRLF move
  1882.               the cursor to the first character of the line following the
  1883.               block.  The block is  now defined by the  marker and cursor
  1884.               positions.  
  1885.  
  1886.  
  1887.  
  1888.         4.2  Moving a Block  
  1889.  
  1890.         To move  a block  of text  from one  part of  a file  to another,
  1891.         delete the block  using the  Block Delete command.   This deletes
  1892.         the block from its original position  and moves it into the block
  1893.         buffer.  Now move  the cursor to  the new location  for the block
  1894.         and use the command Block Insert.  
  1895.  
  1896.  
  1897.  
  1898.         4.3  Making Multiple Copies of a Block  
  1899.  
  1900.         If you  have a  section of  text that  you want  to reproduce  at
  1901.         several places, use the Block Copy  command to copy the the block
  1902.         into the block buffer, then move the cursor to each location that
  1903.         the block is to  be reproduced and execute  the Block Insert com-
  1904.         mand.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.         (E.Y.G.)                     - 28 -             (printed 4-18-86)
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1918.  
  1919.  
  1920.  
  1921.         4.4  Moving or Copying a Line  
  1922.  
  1923.         A single line can be moved  using the block commands, but another
  1924.         method requires fewer  keystrokes.  Place the  cursor anywhere on
  1925.         the line to be  moved and delete  the line using  the DELETE LINE
  1926.         key.  Then move the cursor to the line's new destination, and ex-
  1927.         ecute the Undelete command.  The  entire line is moved, including
  1928.         the CRLF terminator.  
  1929.  
  1930.         To copy a line, first delete the line, then immediately re-insert
  1931.         it with  the  Undelete command,  then  move the  cursor  anywhere
  1932.         copies are needed and Undelete it again.  
  1933.  
  1934.  
  1935.  
  1936.         4.5  Moving or Copying Blocks Between Files  
  1937.  
  1938.         There are  two  techniques of  transferring  blocks between  disk
  1939.         files.  The choice of techniques  depends on the available memory
  1940.         and the size of the source and destination files.  
  1941.  
  1942.         Method 1:   Source and destination files are small enough to both
  1943.                     reside in the editor's  two file buffers  at the same
  1944.                     time.  
  1945.  
  1946.                 1.  Read each file into a file buffer.  Use the File Edit
  1947.                     command to  read the  first file,  and File  Other to
  1948.                     read the second.  
  1949.  
  1950.                 2.  Copy or Delete  the block  from the source  file into
  1951.                     the block buffer as described earlier.  
  1952.  
  1953.                 3.  Move the  cursor to  the destination  file using  the
  1954.                     File Other command and use the Block Insert command.  
  1955.  
  1956.         Method 2:   The available  memory pool  is only  large enough  to
  1957.                     hold each file separately.  
  1958.  
  1959.                 1.  Read the  source file  into  the editor  and Copy  or
  1960.                     Delete the block into the block buffer.  
  1961.  
  1962.                 2.  Use the  File Edit  command to  overwrite the  source
  1963.                     file buffer with the  destination file.  Position the
  1964.                     cursor in the  destination file  buffer and  give the
  1965.                     Block Insert command.  
  1966.  
  1967.  
  1968.  
  1969.         4.6  Positioning the Cursor Quickly in Large Files  
  1970.  
  1971.         When editing large  programs, it is  often necessary to  move be-
  1972.         tween widely  scattered locations  within the  file buffer.   The
  1973.         ability to make  these movements rapidly  can save a  lot of time
  1974.  
  1975.  
  1976.  
  1977.         (E.Y.G.)                     - 29 -             (printed 4-18-86)
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  1984.  
  1985.  
  1986.  
  1987.         and frustration.  You can use any of the following techniques.  
  1988.  
  1989.            -  Use the Windows 2-windows command  to split the screen into
  1990.               two different views on  a file buffer.   This powerful com-
  1991.               mand allows you to view any part of a file buffer while you
  1992.               edit another.  
  1993.  
  1994.            -  Define the marker  at a  position that  you will  return to
  1995.               often.  The Jump Marker command will move you to that posi-
  1996.               tion quickly.  
  1997.  
  1998.            -  Note the line number of a position that you go to frequent-
  1999.               ly, and use  the Jump  Line command  to return  there.  The
  2000.               current line number is always shown on the status line.  
  2001.  
  2002.            -  If you need to be near the  beginning or end of the buffer,
  2003.               use the HOME or SHIFT-HOME (END) keys.  
  2004.  
  2005.            -  The paging keys, PREV (PgUp) and NEXT (PgDn), move the dis-
  2006.               play window through  the file  very quickly.  As  with most
  2007.               keys, they repeat automatically when  held down.  You won't
  2008.               be able  to read  the  text as  it flies  by,  but you  can
  2009.               monitor the line numbers displayed on the status line.  
  2010.  
  2011.            -  If you know a unique character string in the text near your
  2012.               destination, such as a variable  name or function name, use
  2013.               the Search command to move there quickly.  
  2014.  
  2015.  
  2016.  
  2017.         4.7  Replace Applications  
  2018.  
  2019.         Replace is a useful command  with many applications.  Some common
  2020.         uses are renaming a  variable or function name,  or renumbering a
  2021.         BASIC program after  moving a block  of code.  The  following ex-
  2022.         amples illustrate some  capabilities of this  command which might
  2023.         not be immediately apparent.  
  2024.  
  2025.  
  2026.  
  2027.         4.7.1  Global Delete  
  2028.  
  2029.         The Replace command can be used to delete some or all occurrences
  2030.         of a string.  To do this, you must make the replacement string be
  2031.         the null string (no characters).  The first time you execute this
  2032.         command, the default replacement string is null and you can simp-
  2033.         ly press RETURN when you are  prompted with "Replace with what?".
  2034.         However, once  you have  defined a  replacement string,  pressing
  2035.         RETURN will enter the last replacement used.  In this case, press
  2036.         the BACKSPACE  key first,  then the  RETURN key  to enter  a null
  2037.         string.  You will then be able  to selectively delete each occur-
  2038.         rence of the search target.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.         (E.Y.G.)                     - 30 -             (printed 4-18-86)
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  2050.  
  2051.  
  2052.  
  2053.         4.7.2  Anchoring a Search  Pattern to the  Beginning or End  of a
  2054.         Line  
  2055.  
  2056.         You can include the end-of-line terminators  CRLF as part of your
  2057.         search target  by entering  a CONTROL-M  followed by  a CONTROL-J
  2058.         into the search string.  This allows you to restrict the scope of
  2059.         a search or replace operation to  matching strings which occur at
  2060.         the beginning or the end of a line.  
  2061.  
  2062.  
  2063.  
  2064.         4.8  Flexibility With Tabs  
  2065.  
  2066.         The TAB  key  allows you  to  format,  indent, and  comment  your
  2067.         programs in  a  consistent, readable  style  using a  minimum  of
  2068.         keystrokes.  You have the  choice of defining tab  stops at fixed
  2069.         intervals or  at specific  column numbers.   Fixed intervals  are
  2070.         useful for indenting most  structured programming languages.  The
  2071.         editor defaults to tab stops every 8 columns.  
  2072.  
  2073.         In addition to defining tab stops,  you also have the choice with
  2074.         the operation of the TAB key  between inserting tab characters or
  2075.         inserting the number of spaces required to move the cursor to the
  2076.         next tab stop.  Using  spaces rather than tab  characters has the
  2077.         advantage that the format of the file is fixed and independent of
  2078.         tab definitions.  The editor defaults  to using tab characters in
  2079.         files, resulting in smaller file  sizes.  To change the operation
  2080.         of this key, use the Define No-tabs command.  
  2081.  
  2082.         You may find it necessary to convert  a section of code that con-
  2083.         tains tab characters, and replace the  tabs with the correct num-
  2084.         ber of spaces.  This eliminates any problems that the tab charac-
  2085.         ters might cause when  using the file with  another program, such
  2086.         as a print utility.   The conversion can be  done by defining the
  2087.         section of code (or the entire file)  as a block using the marker
  2088.         and cursor, and executing the Convert Tabs->spaces command.  
  2089.  
  2090.         At times  it is  helpful  to be  able to  convert  spaces to  tab
  2091.         characters.   This  has  other   benefits  besides  making  files
  2092.         smaller.  You can, for example, take a file that was indented for
  2093.         printing on a 132  column page, define tab  stops at the original
  2094.         indent columns, and convert  groups of spaces in  the file to tab
  2095.         characters.  By re-defining  the tab stops  at smaller intervals,
  2096.         you may be able  to compress the  spacing of the file  so that it
  2097.         can be printed on an 80 column page.  
  2098.  
  2099.  
  2100.  
  2101.         4.9  Dealing With Limitations of Computer Memory  
  2102.  
  2103.         The editor can only edit files  that fit entirely within its file
  2104.         workspace.  On a typical MS-DOS computer system with 256K memory,
  2105.         files as large as 155,000 bytes  can be edited.  If your computer
  2106.  
  2107.  
  2108.  
  2109.         (E.Y.G.)                     - 31 -             (printed 4-18-86)
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  2116.  
  2117.  
  2118.  
  2119.         has additional  memory you  can edit  files as  large as  580,000
  2120.         bytes (545,000 on an HP150).  
  2121.  
  2122.         The status line  displays the number  of free bytes  available to
  2123.         the editor.  When this number  approaches zero, you are prevented
  2124.         from inserting additional characters into the buffer.  If you try
  2125.         to insert characters  into a  full buffer,  you will  receive the
  2126.         following message: 
  2127.  
  2128.               **** Insufficient free memory for last command. **** 
  2129.  
  2130.         You will be permitted  to continue editing and  to save the file,
  2131.         but to continue adding characters to the file buffer you must in-
  2132.         crease its size.  The following suggestions may help: 
  2133.  
  2134.            -  Use the /A switch when you start the editor.  This gives an
  2135.               additional 19K bytes to the buffer space.  
  2136.  
  2137.            -  Don't use two file buffers when editing large files.  
  2138.  
  2139.            -  Use tab characters in the file buffer where possible.  
  2140.  
  2141.            -  If you have moved  any text into the  block buffer, you can
  2142.               release that memory to the file  buffer by defining a block
  2143.               of a single character and using the Block Copy command.  
  2144.  
  2145.            -  Break the file up into two smaller files.  If the file fits
  2146.               in the editor's  file buffer,  use the Block  Write command
  2147.               for this purpose.   If the file  is too large  to read into
  2148.               the buffer, use  DEBUG's Name  and Write commands  to split
  2149.               the file.  
  2150.  
  2151.  
  2152.  
  2153.         4.10  Dealing With Limitations of Disk Space  
  2154.  
  2155.         The normal procedure  for exiting the  editor is to  use the File
  2156.         Save+exit command.   This keeps  a  backup of  the original  file
  2157.         along with  the current  changes on  the same  disk.  There  must
  2158.         therefore be enough space on the disk for two copies of the file.
  2159.         If this becomes a problem, use one of the following alternatives: 
  2160.  
  2161.            -  Use the File Write command to  save the file.  This command
  2162.               does not create an automatic backup file.  
  2163.  
  2164.            -  Insert a formatted  blank disk to  save the changes  to the
  2165.               file.  You can change  disks any time during  the edit ses-
  2166.               sion except at those times when the disk is being accessed.  
  2167.  
  2168.            -  Use File Command to temporarily  exit to MS-DOS, and delete
  2169.               or move files from the disk to create additional space.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.         (E.Y.G.)                     - 32 -             (printed 4-18-86)
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  2182.  
  2183.  
  2184.  
  2185.         5.  MESSAGES  
  2186.  
  2187.         This section explains the  meanings of messages  generated by the
  2188.         editor.  
  2189.  
  2190.  
  2191.         Can't delete old .BAK file.  
  2192.  
  2193.               Before writing  the file  buffer  to disk,  the editor  at-
  2194.               tempted to delete the old backup  file and could not.  This
  2195.               can occur if the file has the readonly attribute.  
  2196.  
  2197.  
  2198.         Define block begin/end with marker and cursor.  
  2199.  
  2200.               You gave a block  command, but the cursor  is either at the
  2201.               marked character  or closer  to the  beginning of  the file
  2202.               buffer.  The block commands use  the marker position as the
  2203.               beginning of the  block and  the cursor as  the end  of the
  2204.               block.  
  2205.  
  2206.  
  2207.         Drive not ready.  
  2208.  
  2209.               The disk cannot be accessed.  Some possible reasons are: 
  2210.  
  2211.                  -  The disk may be write protected.  
  2212.  
  2213.                  -  The line power to the disk may be off.  
  2214.  
  2215.                  -  You may have  specified a non-existent  drive.  Check
  2216.                     the drive letter specification in the filename.  
  2217.  
  2218.                  -  The disk drive door may be open.  
  2219.  
  2220.               Try to correct the problem and retry the command.  
  2221.  
  2222.  
  2223.         *** ED requires 80X25 video display mode *** 
  2224.  
  2225.               The equipment switches in an IBM  compatible PC are not set
  2226.               for an 80 column display.  The editor cannot be run using a
  2227.               40 column display.  
  2228.  
  2229.  
  2230.         Edit what file?  
  2231.  
  2232.               You are being asked for the name of either an existing disk
  2233.               file to be edited, or a  new filename that will be created.
  2234.               Filenames can include drive and  path specifiers.  Refer to
  2235.               your MS-DOS  User's  Guide for  a  complete description  of
  2236.               filenames.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.         (E.Y.G.)                     - 33 -             (printed 4-18-86)
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  2248.  
  2249.  
  2250.  
  2251.         Editing file <file> 
  2252.  
  2253.               The editor is in the edit mode.   <file> is the name of the
  2254.               file that is displayed in the active file buffer.  
  2255.  
  2256.  
  2257.         Editing new un-named file 
  2258.  
  2259.               You are editing a new file that  is not yet named.  You can
  2260.               name the file when you save the file buffer.  
  2261.  
  2262.  
  2263.         Enter new left  margin column,  and optionally, right  margin and
  2264.         paragraph indent.  
  2265.  
  2266.               The number(s)  that you  entered as  new paragraph  margins
  2267.               were either out  of range, or  mistyped.  If more  than one
  2268.               number is  entered,  use spaces  or  commas as  separators.
  2269.               Margins can range from columns 1 to 999.  It is an error to
  2270.               specify a right margin as smaller than the left margin.  
  2271.  
  2272.  
  2273.         Enter tab stops as a list of  numbers between 1 and 255 separated
  2274.         by commas.  
  2275.  
  2276.               In defining tab stop columns, you  entered a number that is
  2277.               outside of the range  from 1 to 255.   Individual stops can
  2278.               only be  defined  within  these limits.   Enter  the  stops
  2279.               again, or press ESCAPE to abort the command.  
  2280.  
  2281.  
  2282.         Error creating file.  
  2283.  
  2284.               During the  execution of  either a  Block Write  or a  File
  2285.               Write command,  the editor  attempted to  create the  named
  2286.               file and could not, possibly because: 
  2287.  
  2288.                  -  The disk is write protected.  
  2289.  
  2290.                  -  The filename is not valid.  
  2291.  
  2292.                  -  There is no space left on the disk.  
  2293.  
  2294.  
  2295.         Error reading file.  
  2296.  
  2297.               While reading a disk file into  the editor's file buffer, a
  2298.               disk error was reported  by the operating  system.  This is
  2299.               most likely due  to a  problem with the  disk media  or the
  2300.               computer's disk drive hardware.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.         (E.Y.G.)                     - 34 -             (printed 4-18-86)
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  2314.  
  2315.  
  2316.  
  2317.         Error reading the configuration file.  
  2318.  
  2319.               The editor configuration file being read is not the correct
  2320.               length, or has an incorrect "signature".  This file has the
  2321.               filename prefix "EDCONFIG", and the same filename extension
  2322.               as the file being read into  the editor's file buffer.  The
  2323.               configuration file should  be written  again with  the File
  2324.               Profile command.  
  2325.  
  2326.  
  2327.         Error re-setting the default directory.  
  2328.  
  2329.               When File Command is invoked,  the editor saves the default
  2330.               disk drive and default directory so that it can be restored
  2331.               when the shell program is exited.  This message usually in-
  2332.               dicates that the disk was removed from the default drive.  
  2333.  
  2334.  
  2335.         Error shelling to command processor.  
  2336.  
  2337.               The editor attempted  to run  the MS-DOS shell  program and
  2338.               could not.  Either the file could not be found in the drive
  2339.               and directory  specified by  the environment  parameter, or
  2340.               there was insufficient  memory to  run the  program.  Check
  2341.               that the shell program (usually COMMAND.COM) is on the cor-
  2342.               rect disk.  
  2343.  
  2344.  
  2345.         Error writing to file.  
  2346.  
  2347.               An error was  reported by  the operating system  while data
  2348.               was being written to a disk  file.  Since the file was suc-
  2349.               cessfully opened  before  writing  began, this  problem  is
  2350.               probably due to a damaged or  full disk.  Retry the command
  2351.               using a different disk or drive.  
  2352.  
  2353.  
  2354.         File extension too long.  
  2355.  
  2356.               You have entered a filename with an extension that does not
  2357.               conform to the  MS-DOS filename conventions.   Filename ex-
  2358.               tensions may have a maximum length of three characters.  
  2359.  
  2360.  
  2361.         Filename is too long.  
  2362.  
  2363.               You have entered a filename having a total length which ex-
  2364.               ceeds the  editor's internal  capacity.  The  maximum total
  2365.               length of a file specification,  including drive and direc-
  2366.               tory pathnames, is 70 characters.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.         (E.Y.G.)                     - 35 -             (printed 4-18-86)
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  2380.  
  2381.  
  2382.  
  2383.         Filename prefix is too long.  
  2384.  
  2385.               You have entered  a filename with  an prefix that  does not
  2386.               conform  to  the  MS-DOS  filename  conventions.   Filename
  2387.               prefixes may have a maximum length of eight characters.  
  2388.  
  2389.  
  2390.         **** Insufficient free memory for last command.  **** 
  2391.  
  2392.               You have given a command that  requires more memory than is
  2393.               currently available in the file  buffer.  Refer to the sec-
  2394.               tion titled "Dealing with Limitations of Computer Memory".  
  2395.  
  2396.  
  2397.         ***Insufficient memory for ED*** 
  2398.  
  2399.               There is  not enough  memory available  to run  the editor.
  2400.               Refer to the  section titled  "Dealing with  Limitations of
  2401.               Computer Memory".  
  2402.  
  2403.  
  2404.         Marked text exceeds block buffer size by <n> characters.  
  2405.  
  2406.               You attempted to Append, Copy or Delete a block that is too
  2407.               large for the  available memory.  You  will be able  to use
  2408.               the command if  you make the  block smaller by  <n> charac-
  2409.               ters.  
  2410.  
  2411.  
  2412.         No COMSPEC in environment string.  
  2413.  
  2414.               You have given the File Command  command and there is not a
  2415.               parameter  in   the   MS-DOS   environment  of   the   form
  2416.               "COMSPEC=<filespec>".  Use the MS-DOS  SET command to enter
  2417.               the name of the shell program into the environment.  
  2418.  
  2419.  
  2420.         Out of disk space.  
  2421.  
  2422.               In writing a file to a disk, the disk became full.  You can
  2423.               insert a new disk and give the command again.  Refer to the
  2424.               section titled "Dealing with Limitations of Disk Space".  
  2425.  
  2426.  
  2427.         Printer not ready.  
  2428.  
  2429.               You have tried  to print a  block and the  printer does not
  2430.               respond.  Check for the following conditions: 
  2431.  
  2432.                  -  Is the printer ON LINE?  
  2433.  
  2434.                  -  Is it out of paper?  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.         (E.Y.G.)                     - 36 -             (printed 4-18-86)
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  2446.  
  2447.  
  2448.  
  2449.                  -  Is it plugged into an AC outlet and turned ON?  
  2450.  
  2451.                  -  Is the printer cable connected?  
  2452.  
  2453.                  -  Is your printer configured as the PRN or LPT1 device?  
  2454.  
  2455.               Either correct the condition and  retry the command, or use
  2456.               the ESCAPE key to backup out of the command menus.  
  2457.  
  2458.  
  2459.         READING ....  
  2460.  
  2461.               A file  is being  read from  the disk.   As each  2048-byte
  2462.               block is read, an additional dot is displayed.  
  2463.  
  2464.  
  2465.         Renaming original file to .BAK 
  2466.  
  2467.               The editor  is  creating  a  backup file  by  renaming  the
  2468.               original disk file to a filename with a .BAK extension.  
  2469.  
  2470.  
  2471.         SHIFT = <n> 
  2472.  
  2473.               While the Adjust command is in use, the current shift count
  2474.               is displayed on  the message line.   This is the  number of
  2475.               columns that  each line  the  cursor is  moved  to will  be
  2476.               shifted.  
  2477.  
  2478.  
  2479.         Target string not found.  
  2480.  
  2481.               No match of the target string  was found during a Search or
  2482.               Replace operation.  Select Quit to return to the edit mode,
  2483.               or press ESCAPE to  backup in the command  tree and specify
  2484.               another search target.  
  2485.  
  2486.  
  2487.         The fixed tab interval must be between 2 and 100.  
  2488.  
  2489.               You have  specified an  invalid tab  interval.  Enter  your
  2490.               choice again,  or only  press RETURN  to keep  the previous
  2491.               value active.  
  2492.  
  2493.  
  2494.         Unable to open file.  
  2495.  
  2496.               The file that you specified for a Merge operation could not
  2497.               be opened.  Check  to see  if you  have typed  the filename
  2498.               correctly, that you  have specified  the correct  drive and
  2499.               path if the file  is not in the  current directory, or that
  2500.               you have the correct disk in the drive.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.         (E.Y.G.)                     - 37 -             (printed 4-18-86)
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.         ED.EXE          Program Text Editor User's Manual    Version 1.05
  2512.  
  2513.  
  2514.  
  2515.         Unable to open or create file.  
  2516.  
  2517.               The file  that you  specified  to be  edited  could not  be
  2518.               found.  The  editor attempted  to create  a file  with that
  2519.               name and could not, probably because  the filename is not a
  2520.               legal DOS filename or is prefixed with a non-existent path-
  2521.               name.  
  2522.  
  2523.  
  2524.         WAIT .....  
  2525.  
  2526.               The editor is performing an operation that may take several
  2527.               seconds to complete.  
  2528.  
  2529.  
  2530.         Writing block to file <file> 
  2531.  
  2532.               The editor has  successfully opened  <file> and  is writing
  2533.               the marked text to it.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.         (E.Y.G.)                     - 38 -             (printed 4-18-86)
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.                                                                          
  2578.  
  2579.  
  2580.  
  2581.         TABLE OF CONTENTS 
  2582.  
  2583.  
  2584.         1.  GENERAL INFORMATION.........................................1 
  2585.          1.1  Program Versions and Requirements.........................2 
  2586.  
  2587.         2.   EDITOR OPERATION...........................................2 
  2588.          2.1  Running the Editor........................................2 
  2589.          2.2  Crossing Directories......................................3 
  2590.          2.3  Exiting the editor........................................3 
  2591.          2.4  Use of Computer Memory....................................3 
  2592.          2.5  File Buffers..............................................4 
  2593.           2.5.1  The Block Buffer.......................................4 
  2594.           2.5.2  The Deleted Line Buffer................................4 
  2595.          2.6  Edit Modes................................................5 
  2596.          2.7  Command Mode..............................................5 
  2597.          2.8  The Display Screen........................................6 
  2598.           2.8.1  The Command Line.......................................6 
  2599.           2.8.2  The Message Line.......................................6 
  2600.           2.8.3  The Status Line........................................6 
  2601.           2.8.4  The File Windows.......................................7 
  2602.          2.9  Moving the Cursor.........................................7 
  2603.          2.10  The Marker...............................................8 
  2604.          2.11  Saving the File Buffer...................................9 
  2605.          2.12  Editor Configuration Files...............................9 
  2606.           2.12.1  Enabling Configuration Files.........................10 
  2607.           2.12.2  Writing a Configuration File.........................10 
  2608.           2.12.3  Disabling Configuration Files........................11 
  2609.  
  2610.         3.  GENERAL REFERENCE..........................................11 
  2611.          3.1  Special Editing Keys.....................................11 
  2612.           3.1.1  ESCAPE (or F8)........................................11 
  2613.           3.1.2  CLEAR LINE (SHIFT-END)................................11 
  2614.           3.1.3  DELETE LINE (SHIFT-DEL)...............................12 
  2615.           3.1.4  DELETE CHAR (DEL).....................................12 
  2616.           3.1.5  INSERT CHAR (INS).....................................12 
  2617.           3.1.6  INSERT LINE (SHIFT-INS)...............................12 
  2618.           3.1.7  HOME..................................................12 
  2619.           3.1.8  SHIFT-HOME (END)......................................12 
  2620.           3.1.9  UP....................................................12 
  2621.           3.1.10  DOWN.................................................13 
  2622.           3.1.11  LEFT.................................................13 
  2623.           3.1.12  RIGHT................................................13 
  2624.           3.1.13  SHIFT-UP.............................................13 
  2625.           3.1.14  SHIFT-DOWN...........................................13 
  2626.           3.1.15  SHIFT-LEFT...........................................13 
  2627.           3.1.16  SHIFT-RIGHT..........................................13 
  2628.           3.1.17  CTRL-LEFT............................................13 
  2629.           3.1.18  CTRL-RIGHT...........................................14 
  2630.           3.1.19  PREV (PgUp)..........................................14 
  2631.           3.1.20  NEXT (PgDn)..........................................14 
  2632.           3.1.21  CAPS (CAPS LOCK).....................................14 
  2633.           3.1.22  RETURN...............................................14 
  2634.  
  2635.  
  2636.  
  2637.                                       - i -                              
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.                                                                          
  2644.  
  2645.  
  2646.  
  2647.           3.1.23  BACKSPACE............................................14 
  2648.           3.1.24  TAB..................................................14 
  2649.          3.2  Control Characters.......................................15 
  2650.           3.2.1  Substitute (CTRL-Z)...................................15 
  2651.           3.2.2  Carriage Return (CTRL-M)..............................15 
  2652.           3.2.3  Line Feed (CTRL-J)....................................16 
  2653.           3.2.4  Escape (CTRL-[).......................................16 
  2654.           3.2.5  Backspace (CTRL-H)....................................16 
  2655.           3.2.6  Tab (CTRL-I)..........................................16 
  2656.          3.3  Commands.................................................17 
  2657.           3.3.1  Adjust................................................17 
  2658.           3.3.2  Block Append..........................................17 
  2659.           3.3.3  Block Copy............................................17 
  2660.           3.3.4  Block Delete..........................................18 
  2661.           3.3.5  Block Fill............................................18 
  2662.           3.3.6  Block Insert..........................................18 
  2663.           3.3.7  Block Justify.........................................18 
  2664.           3.3.8  Block Print...........................................18 
  2665.           3.3.9  Block Write...........................................19 
  2666.           3.3.10  Convert Lowercase->uppercase.........................19 
  2667.           3.3.11  Convert Spaces->tabs.................................19 
  2668.           3.3.12  Convert Tabs->spaces.................................19 
  2669.           3.3.13  Convert Uppercase->lowercase.........................20 
  2670.           3.3.14  Define Case..........................................20 
  2671.           3.3.15  Define Ignore........................................20 
  2672.           3.3.16  Define Marker........................................20 
  2673.           3.3.17  Define No-tabs.......................................20 
  2674.           3.3.18  Define Paragraph.....................................21 
  2675.           3.3.19  Define Tabs Fixed....................................21 
  2676.           3.3.20  Define Tabs Variable.................................21 
  2677.           3.3.21  Define Use-tabs......................................22 
  2678.           3.3.22  Define Wordwrap Disable..............................22 
  2679.           3.3.23  Define Wordwrap Enable...............................22 
  2680.           3.3.24  File Command.........................................22 
  2681.           3.3.25  File Edit............................................23 
  2682.           3.3.26  File Merge...........................................23 
  2683.           3.3.27  File Other...........................................23 
  2684.           3.3.28  File Profile.........................................23 
  2685.           3.3.29  File Quit............................................24 
  2686.           3.3.30  File Save+exit.......................................24 
  2687.           3.3.31  File Update..........................................24 
  2688.           3.3.32  File Write...........................................24 
  2689.           3.3.33  Jump Beginning.......................................25 
  2690.           3.3.34  Jump End.............................................25 
  2691.           3.3.35  Jump Line............................................25 
  2692.           3.3.36  Jump Marker..........................................25 
  2693.           3.3.37  Replace..............................................25 
  2694.           3.3.38  Search...............................................26 
  2695.           3.3.39  Undelete.............................................26 
  2696.           3.3.40  Window 1-window......................................26 
  2697.           3.3.41  Window 2-windows.....................................26 
  2698.           3.3.42  Window Other-window..................................26 
  2699.          3.4  MS-DOS Command Line Switches.............................27 
  2700.  
  2701.  
  2702.  
  2703.                                      - ii -                              
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.                                                                          
  2710.  
  2711.  
  2712.  
  2713.           3.4.1  /a....................................................27 
  2714.           3.4.2  /d....................................................27 
  2715.           3.4.3  /m<blocks>............................................27 
  2716.          3.5  Environment Parameters...................................27 
  2717.  
  2718.         4.  EDITING TECHNIQUES.........................................28 
  2719.          4.1  Defining a Block.........................................28 
  2720.          4.2  Moving a Block...........................................28 
  2721.          4.3  Making Multiple Copies of a Block........................28 
  2722.          4.4  Moving or Copying a Line.................................29 
  2723.          4.5  Moving or Copying Blocks Between Files...................29 
  2724.          4.6  Positioning the Cursor Quickly in Large Files............29 
  2725.          4.7  Replace Applications.....................................30 
  2726.           4.7.1  Global Delete.........................................30 
  2727.           4.7.2  Anchoring a Search Pattern to the Beginning or End of
  2728.                  a Line   31 
  2729.          4.8  Flexibility With Tabs....................................31 
  2730.          4.9  Dealing With Limitations of Computer Memory..............31 
  2731.          4.10  Dealing With Limitations of Disk Space..................32 
  2732.  
  2733.         5.  MESSAGES...................................................33 
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.                                      - iii -                             
  2770.  
  2771.  
  2772.  
  2773.